home *** CD-ROM | disk | FTP | other *** search
/ Software Vault: The Gold Collection / Software Vault - The Gold Collection (American Databankers) (1993).ISO / cdr25 / gtak100.zip / README.AK < prev    next >
Text File  |  1993-03-03  |  12KB  |  306 lines
  1. ┌─────────────────────────────────────────────────────────────────────────┐
  2. │                                                                         │
  3. │                  SCSI TAPE BACKUP for DOS and OS/2                      │
  4. │                  ─────────────────────────────────                      │
  5. │                       and Adaptec Host Adapter                          │
  6. │                       ────────────────────────                          │
  7. │                                                                         │
  8. │                             Version 1.0                                 │
  9. │                                                                         │
  10. │       Autor:  Andreas Kaiser                                            │
  11. │               Fido:   2:241/7220.9                                      │
  12. │               Subnet: kaiser@ananke.stgt.sub.org                        │
  13. │               Voice:  49-711-766116                                     │
  14. │                                                                         │
  15. └─────────────────────────────────────────────────────────────────────────┘
  16.  
  17. Legal notice (german):
  18. ----------------------
  19.  
  20. Ich übernehme für die Programme keinerlei Gewährleistung für korrekte
  21. Funktion oder irgendwelche Folgeeffekte. Es liegt in der Natur eines
  22. derartigen Programms, dass Fehlbenutzung oder darin enthaltene Fehler
  23. den Inhalt der Festplatte zerstören können. Dafür übernehme ich
  24. keinerlei Haftung.
  25.  
  26. ─────────────────────────────────────────────────────────────────────────
  27. Contents:
  28. ---------
  29.  
  30. GTAR.EXE    Modified GNU-TAR for DOS and ASPI4DOS.
  31. TAPE.EXE    Tape control utility for DOS and ASPI4DOS.
  32.  
  33. GTARP.EXE    Modified GNU-TAR for OS/2 1.3 / 2.0 and ASPI manager.
  34. TAPEP.EXE    Tape control utility for ..
  35.  
  36. COMPRESS.EXE    A file compression program for OS/2, invoked by
  37.         the "z" switch. Bound executable for DOS and OS/2.
  38.         The compression rate is not as good as LHARCs and
  39.         it is not as fast as PKZIP -es, but COMPRESS can
  40.         be used with pipes on both ends. It is a DOS port
  41.         of the well known Unix compress program. Supports
  42.         16-bit compression mode.
  43.  
  44. BUFFER.EXE    Pipe buffer & reblock program for OS/2. Invoked by
  45.         the "z" switch when operating on character device.
  46.  
  47. ASPITAPE.SYS    Tape device driver for OS/2 1.3 / 2.0, sitting on
  48.         top of ASPI.
  49.  
  50. README.AK    This file.
  51. README.TAR    README from original TAR distribution.
  52. TAR.TEX        TeXinfo documentation of original TAR.
  53.  
  54. ─────────────────────────────────────────────────────────────────────────
  55. Installation:
  56. -------------
  57.  
  58. DOS Version:
  59. ------------
  60.  
  61. Requires ASPI4DOS (ASW-1410) or equivalent ASPI manager.
  62.  
  63. set TAPE=+++TAPE$4        For streamer target ID 4
  64. set TAPEMODE=0            Tape sense mode (see below)
  65.  
  66. OS/2 1.3 Version:
  67. -----------------
  68.  
  69. Requires an ASPI manager. ASPI managers usually are included in the
  70. DISK01.SYS or ASPI4OS2.SYS drivers (ASW-1420) for Adaptec SCSI host
  71. adapters. If you are not sure if your device driver contains an ASPI
  72. manager, look for a present character device named SCSIMGR$.
  73.  
  74. Under OS/2, the tape device can be accessed like any other sequential
  75. character device, using standard read and write calls (caution:
  76. restricted to multiples of 512!). It is possible to COPY whole volumes
  77. from tape to disk.
  78.  
  79. DEVICE=<path>\ASPITAPE.SYS TAPE$4 4 S0
  80.  
  81.     ASPITAPE command line:
  82.  
  83.         <1st word>    device name, in uppercase
  84.         A<digit>    host adapter number (0..1, default is 0)
  85.         digit        streamer target ID (0..7)
  86.         S<digit>    tape sense mode (0..2, see below)
  87.  
  88. set TAPE=+++TAPE$4        Same device name as above. The leading "+"
  89.                 signs signal GTAR to use the tape interface
  90.                 instead of the standard file interface.
  91.  
  92. Tape sense modes:
  93.     0    Sense key, should be ok for most SCSI streamers
  94.     1    Tandberg TDC3600 series, prints more status information
  95.     2    SCSI-2 (not tested)
  96.  
  97. ─────────────────────────────────────────────────────────────────────────
  98. GNU TAR:
  99. --------
  100.  
  101. This is not an introduction into TAR. Look into the TeX file or a good
  102. Unix book to learn more about the usage of TAR.
  103.  
  104. If GTAR is invoked without explicit archive specification, it always
  105. positions to end-of-tape before data is written to the tape will
  106. automatically append a filemark. This way GTAR never erases existing
  107. tape contents when you accidentally forgot the -f switch on the command
  108. line. If you want to rewrite the tape from the beginning, either erase
  109. the tape (TAPE ERASE, see below) or write an empty filemark at the
  110. beginning of the tape (TAPE REWIND MARK).
  111.  
  112. I'm quite sure multi-volume archives won't work when the tape reaches
  113. its limit since it is very time-consuming to test such a behaviour
  114. (30min per trial). If you need multi-volume archives, use the option -S
  115. to split the data in chunks of a size somewhat less than the tape
  116. capacity.
  117.  
  118. Get help with
  119.     gtar -help
  120.  
  121. New options:
  122.  
  123.     -S <n>[B|K|M]    Split archive, B = type block, K = 1024 bytes
  124.             M = 1024 * 1024 bytes.
  125.             The tape block size depends on option -b, the
  126.             default is a block size of 10KB.
  127.  
  128.         Example:
  129.             -S 140M        Split into chunks of 140 MB.
  130.  
  131.     -F filename    Maintain a tape directory. New data is appended
  132.             to the (text) file if it already exists.
  133.  
  134.             This option allows fast random access to
  135.             single files, provided the streamer supports
  136.             the random access commands of Tandberg TDC3600.
  137.             Most streamers (like Wangtek) do not support
  138.             these commands, so there is no chance for a fast
  139.             random access on these models. This is a serious
  140.             fault of the SCSI command set prior to SCSI-2.
  141.  
  142.             This option is not usable with compression mode.
  143.  
  144.     -p        Include SYSTEM and HIDDEN files on backup.
  145.             Account for SYSTEM and HIDDEN file attributes
  146.             on list and restore. These attributes are
  147.             encoded in the group and world execute bits
  148.             of the Unix style file mode.
  149.  
  150.     -Y        Don't recurse. Do not include files within
  151.             subdirectories. It does include the names
  152.             of the first subdirectory level but not the
  153.             contents.
  154.  
  155.     -Z        Was alias for -z. Now forces buffered pipe
  156.             compression mode even if the archive is not
  157.             a device.
  158.  
  159. This is software designed for (and ported from) Unix systems, so don't
  160. expect all options and features to work. And don't be too much confused
  161. by some warnings, which might occur when GTAR tries to set attributes
  162. or filetimes at times when this is not allowed under DOS or OS/2.
  163.  
  164. The OS/2 version automatically saves and restores Extended Attributes.
  165. The length of paths and filenames is limited by the standardized TAR
  166. format to a maximum of 100 bytes. Path and filename specifications are
  167. sensitive to upper/lower case and forward/backward slash convention.
  168.  
  169. Since the TAR format is standardized and available on every UNIX
  170. system, you can use GTAR to exchange data with UNIX systems. Even
  171. compressed data is compatible with 32-bit Unix systems.
  172.  
  173. Paths and filenames should be specified with forward slashes as path
  174. separators. On extract, paths and filenames must be specified exactly
  175. as shown by "GTAR t".
  176.  
  177. Hint: On archive creation GTAR removes leading absolute path indicators
  178. such as drive letters and leading slashes (verbose). If you save
  179. several partitions on the same tape volume (a tape volume is a single
  180. tape file - consecutive tape data until end-of-tape or filemark), you
  181. might not be able to distinguish files with the same path and filename
  182. on restore. Use a seperate volume (run GTAR seperately) for each
  183. logical disk.
  184.  
  185. Hint: Although the output of the "v" option looks nice, it might be
  186. wise to drop it for large backups. When a large number of small files
  187. is written to tape, the screen output might slow down the tape output,
  188. forcing the tape into inefficient stop-and-go mode.
  189.  
  190. Hint: A disk cache with write caching enabled will greatly improve
  191. performance of restore operation under DOS and OS/2. Disk writes using
  192. OS/2 1.x FAT filesystem are very slow, so if you have to restore whole
  193. OS/2 FAT filesystems, restore them to HPFS and later move the data, to
  194. avoid stop-and-go mode. Or restore them using DOS with a good
  195. write-cache like HyperDisk.
  196.  
  197. OS/2 only: There will be no trailing filemark if the tape is written as
  198. via filename (e.g. "-f TAPE$4") or via explicit pipe (see BUFFER
  199. below).
  200.  
  201. Examples:
  202.  
  203.     gtar cp .        Backup the current directory and
  204.                 all subdirectories including hidden
  205.                 and system files.
  206.  
  207.     gtar tpv        List all files on the volume.
  208.  
  209.     gtar xpv        Restore whole volume.
  210.  
  211.     gtar x path/file    Restore a single file or a directory
  212.                 tree. Filenames are case sensitive.
  213.                 Always use forward slashes.
  214.  
  215.     gtar -c -v -F c:/tar_maps/tape.dir c:/
  216.                 Backup logical disk c: and append a
  217.                 tape directory to the specified file.
  218.  
  219.     gtar -x -v -F c:/tar_maps/tape.dir this/is/a/single/file
  220.                 Restore "this/is/a/single/file" using
  221.                 Tandbergs random access commands.
  222.  
  223. OS/2 compressed backup performance on a 486 33MHz equipped with a
  224. 5MB/min streamer is a compression rate of 1.5 over a whole disk with
  225. 90MB binaries, achieving an effective disk data throughput of 85 KB/sec
  226. and a tape data throughput of 55 KB/sec. When storing the backup on
  227. diskette (a way to exchange HPFS files), compressed data throughput is
  228. faster than the diskette data throughput. Therefore compressed mode can
  229. be considerably faster than uncompressed mode, depending on speed of
  230. the machine and the data throughput of the backup device.
  231.  
  232. Warning: If a compressed backup volume contains a bad tape block, all
  233. data of the volume (tape file) starting with the bad block is lost.
  234. Uncompressed volumes are recoverable by skipping beyond the bad block,
  235. compressed volumes are not recoverable. COMPRESS was not written with
  236. tape backups in mind.
  237.  
  238. ─────────────────────────────────────────────────────────────────────────
  239. Tape utility:
  240. -------------
  241.  
  242. Just run it without arguments to get usage information. You can specify
  243. multiple verbs in a single call, unless the -Nowait option is specified.
  244. Case-insensitive.
  245.  
  246. Examples:
  247.     tape rew        Rewind tape.
  248.     tape ret        Retension tape.
  249.     tape file        Skip until next filemark.
  250.     tape end        Position to end of written data.
  251.     tape mark        Write filemark.
  252.     tape erase        Erase tape.
  253.  
  254. ─────────────────────────────────────────────────────────────────────────
  255. Pipe buffer:
  256. ------------
  257.  
  258. Command line options:
  259.  
  260.     -s <number>    Buffer size, 64K..4096K.
  261.     -b <number>    Reblock to a multiple of <number> bytes
  262.             per output block. Pad output with 0 if
  263.             necessary (<number> <= 32768).
  264.     -i <number>    Refill buffer when <number> % empty.
  265.     -o <number>    Flush buffer when <number> % filled.
  266.             Default for -i and -o is 100.
  267.  
  268. When called with "-/" (or any other invalid option) as argument, BUFFER
  269. prints a small usage info. This usage shows the default buffer size as
  270. second number in the line corresnponding to "-s".
  271.  
  272. The default buffer size depends on the version of the operating system:
  273.  1.3: The size of the largest contiguous area (DosMemAvail) minus 1MB.
  274.  2.0: 2MB. This is subject to change, but there seems to be no reliable
  275.       way to obtain the free memory size on OS/2 2.0 without loosing
  276.       compatibility to 1.3. DosMemAvail is of little use.
  277.  
  278. Examples:
  279. ---------
  280.  
  281. buffer -s1024 < tape$4 | gtar xvf-
  282. gtar cf- . | compress | buffer -i0 -o90 -b512 > tape$4
  283.  
  284. The second example will *not* append a filemark and will *not* seek to
  285. end of tape. TAPE END should be called to seek to end of tape, TAPE
  286. MARK should be called to append a filemark.
  287.  
  288. The command
  289.     gtar cz .
  290. is essentially the same as the second example above, except that GTAR
  291. seeks to end of tape and a filemark is appended to the end of the data.
  292.  
  293. When copying a large file from one disk to another, BUFFER can
  294. considerably reduce position times by using:
  295.     buffer < input-file > output-file
  296.     
  297. ─────────────────────────────────────────────────────────────────────────
  298. Source:
  299. -------
  300.  
  301. Source code for GNU-TAR, the utilities and the OS/2 device driver is
  302. available on request.
  303.  
  304. The specification of my OS/2 tape driver IOCtl interface is available
  305. on request. But you should already have SCSI command set documentation.
  306.